home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1991 …esperately Seeking Seven / Desperately Seeking Seven.2mg / Dev.CD.8 / Essentials / Tools / File.Type.Notes / FTN.D8.8001 < prev    next >
Encoding:
Text File  |  1990-04-29  |  6.2 KB  |  119 lines  |  [04] ASCII Text (0x0000)
  1. Apple II
  2. File Type Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. File Type:         $D8 (216)
  7. Auxiliary Type:    $8001
  8.  
  9. Full Name:     HyperStudio Sampled Sound File
  10. Short Name:    HyperStudio sound
  11.  
  12. Written by:    Matt Deatherage                                      May 1990
  13.  
  14. Files of this type and auxiliary type contain sampled sounds used by the 
  15. HyperStudio(TM) multimedia package.
  16. _____________________________________________________________________________
  17.  
  18. HyperStudio is a complete hypermedia authoring system, including sound 
  19. hardware, sound and graphics tools that lets you create your own hypermedia 
  20. applications.
  21.  
  22. For more information on HyperStudio, contact:
  23.  
  24.     Roger Wagner Publishing, Inc.
  25.     1050 Pioneer Way, Suite P
  26.     El Cajon, CA  92020
  27.     Attention:  HyperStudio Technical Support
  28.     Telephone:  (619) 442-0522
  29.  
  30.  
  31. File Structure
  32.  
  33. HyperStudio sound files contain sampled sound data prefaced by a special 
  34. HyperStudio header.  The header contains information about the file and the 
  35. sound, including sampling and compression information and version numbers.
  36.  
  37.  
  38. The File Format
  39.  
  40. Each HyperStudio file begins with this header information.
  41.  
  42. HFileID       (+000)    4 Bytes         The ASCII characters "SSHS" 
  43.                                         ($53 $53 $48 $53).  This identifies 
  44.                                         the file as a HyperStudio sound.
  45. HDataOffset   (+004)    Long            Offset to the sound data from this 
  46.                                         field.  For this version of the 
  47.                                         HyperStudio sound format, this value 
  48.                                         is always 56 ($38).
  49. HVersID       (+008)    4 Bytes         The version of HyperStudio that 
  50.                                         created this file.  The current 
  51.                                         version is represented by the 
  52.                                         four ASCII characters "RWP " 
  53.                                         ($52 $57 $50 $20).
  54. HDataID       (+012)    4 Bytes         The ASCII characters "SSDK" 
  55.                                         ($53 $53 $44 $4B), identifying the 
  56.                                         creator of the data.  Other 
  57.                                         applications wishing distinct 
  58.                                         creator IDs should contact Roger 
  59.                                         Wagner Publishing.
  60. HLength2      (+016)    Word            Sound sample length of channel 
  61.                                         one in 256-byte pages.
  62. HPbRate2      (+018)    Word            Playback rate for channel one.  The 
  63.                                         value (HPbRate2+40) is the 
  64.                                         freqOffset for the FFStartSound 
  65.                                         toolbox call.
  66.                                         (HPbRate2+40) * 51.40625 is the 
  67.                                         sample's frequency in Hertz.
  68. HVolume2      (+020)    Word            Volume for channel one (0-15).
  69. HEcho2        (+022)    Word            Echo value for channel one (0-127).
  70. HLength       (+024)    Word            Sound sample length of channel zero 
  71.                                         in 256-byte pages.  All other 
  72.                                         channels should have the same 
  73.                                         length.
  74. HAce          (+026)    Word            Bits 0 - 13 of this word contain 
  75.                                         the ACE nBlks parameter (the 
  76.                                         number of 512-byte blocks to 
  77.                                         compress or expand).  Bits 14 and 15 
  78.                                         indicate the type of ACE compression 
  79.                                         used:
  80.                                         %00xxxxxxxxxxxxxxxx - no compression 
  81.                                         %01xxxxxxxxxxxxxxxx - ACE method 1 
  82.                                                               (2:1)
  83.                                         %10xxxxxxxxxxxxxxxx - ACE method 2 
  84.                                                               (8:3)
  85.                                         %11xxxxxxxxxxxxxxxx - reserved
  86. HPbRate       (+028)    Word            Playback rate for channel zero.
  87.                                         The value (HPbRate+40) is the 
  88.                                         freqOffset for the FFStartSound 
  89.                                         toolbox call.
  90.                                         (HPbRate+40) * 51.40625 is the 
  91.                                         sample's frequency in Hertz.
  92. HVolume       (+030)    Word            Volume for channel zero (0-15).
  93. HStereo       (+032)    Word            Number of channels for this sound 
  94.                                         file ( 0 = monophonic, 1 = stereo).
  95. HEcho         (+034)    Word            Echo value for channel zero (0-127).
  96. HReserved     (+036)    Word            Reserved for future use; set to zero.
  97. HRepeat       (+038)    Word            Repeat count for both channels.
  98.                                         The maximum value is 20, which 
  99.                                         indicates the sound is to repeat 
  100.                                         continuously.
  101. HOffset1      (+040)    Long            Offset to the sampled data for 
  102.                                         channel zero.  This should be the 
  103.                                         value (64+(HLength*256)).
  104. HExtra        (+044)    Long            Reserved for future use, set to zero.
  105. HFileName     (+048)    String          If the name of this file is 16 
  106.                                         characters or less, you may 
  107.                                         optionally place it here as a String.
  108.                                         If you do not place the file name 
  109.                                         here, fill these 16 bytes with zeroes.
  110. Data          (+064)    Bytes           The start of the sampled sound data.
  111.  
  112.  
  113. Further Reference
  114. _____________________________________________________________________________
  115.   o  Apple IIgs Toolbox Reference, Volumes 2 & 3
  116.  
  117. HyperStudio(TM) is a trademark of Roger Wagner Publishing, Inc.
  118.  
  119.